Skip to content

Fix DocC workflow: use xcrun docc convert#3

Merged
SoundBlaster merged 2 commits intomainfrom
feature/fix-docc-workflow
Feb 8, 2026
Merged

Fix DocC workflow: use xcrun docc convert#3
SoundBlaster merged 2 commits intomainfrom
feature/fix-docc-workflow

Conversation

@SoundBlaster
Copy link
Owner

Summary

Fixed the failing DocC workflow by replacing the incorrect swift package generate-documentation command with xcrun docc convert.

Problem

The workflow was failing with:

error: Unknown subcommand or plugin name 'generate-documentation'

The swift package generate-documentation command requires the Swift-DocC plugin to be added to Package.swift, which is not available by default.

Solution

Changed the Build Documentation step to use xcrun docc convert directly:

- name: Build Documentation
  run: |
    xcrun docc convert mcpbridge-wrapper.docc \
      --output-path ./docs \
      --transform-for-static-hosting \
      --hosting-base-path mcpbridge-wrapper

This is the standard approach for converting DocC documentation catalogs.

Changes

  • .github/workflows/docs.yml: Replaced swift package generate-documentation with xcrun docc convert

Testing

  • Workflow will be tested after merge
  • Documentation should build successfully
  • GitHub Pages should deploy correctly

@SoundBlaster SoundBlaster force-pushed the feature/fix-docc-workflow branch from f28d079 to 2aaea4b Compare February 8, 2026 12:36
@SoundBlaster SoundBlaster force-pushed the feature/fix-docc-workflow branch from 2aaea4b to 6a0dda4 Compare February 8, 2026 12:40
@SoundBlaster SoundBlaster merged commit 052f0fe into main Feb 8, 2026
2 checks passed
@SoundBlaster SoundBlaster deleted the feature/fix-docc-workflow branch February 8, 2026 12:43
@SoundBlaster SoundBlaster restored the feature/fix-docc-workflow branch February 11, 2026 07:34
@SoundBlaster SoundBlaster deleted the feature/fix-docc-workflow branch February 12, 2026 21:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant